package com.macro.mall.tiny.modules.bms.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.macro.mall.tiny.modules.bms.model.Advert;
import org.apache.ibatis.annotations.Param;

import java.time.LocalDateTime;
import java.util.List;

/**
 * <p>
 * 广告信息表 Mapper 接口
 * </p>
 *
 * @author macro
 * @since 2025-11-21
 */
public interface AdvertMapper extends BaseMapper<Advert> {

    /**
     * 分页查询广告列表
     * @param positionId 广告位ID，用于筛选
     * @param name 广告名称，用于筛选
     * @param startTime 创建时间起始
     * @param endTime 创建时间结束
     * @param offset 偏移量
     * @param limit 每页数量
     * @return 广告列表
     */
    List<Advert> selectPageList(@Param("positionId") Integer positionId, 
                                @Param("name") String name, 
                                @Param("startTime") LocalDateTime startTime, 
                                @Param("endTime") LocalDateTime endTime,
                                @Param("offset") Integer offset, 
                                @Param("limit") Integer limit);

    /**
     * 查询广告总数
     * @param positionId 广告位ID，用于筛选
     * @param name 广告名称，用于筛选
     * @param startTime 创建时间起始
     * @param endTime 创建时间结束
     * @return 广告总数
     */
    int selectTotalCount(@Param("positionId") Integer positionId, 
                         @Param("name") String name, 
                         @Param("startTime") LocalDateTime startTime, 
                         @Param("endTime") LocalDateTime endTime);

    /**
     * 根据广告位ID获取所有有效广告
     * @param positionId 广告位ID
     * @return 有效广告列表
     */
    List<Advert> selectActiveAdvertsByPositionId(@Param("positionId") Integer positionId);
}